home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / timlok10.zip / TIMELOCK.DOC < prev    next >
Text File  |  1992-02-25  |  17KB  |  397 lines
  1.        
  2.  
  3.                                  TIMELOCK
  4.            THE TIME MANAGEMENT SYSTEM FOR BBS DOORS AND PROGRAMS
  5.        
  6.        
  7.        INTRODUCTION:
  8.        ───────────────────────────────────────────────────────────────────
  9.             TimeLock  is  a  simple,  yet powerful  TIME  MANAGEMENT  DOOR
  10.             PROGRAM for mail, game, and other doors on  a  Bulletin  Board
  11.             System.  It  enables BBS Sysop's to control  which  individual 
  12.             callers, or groups of callers, have access to Mail Doors, Game
  13.             Doors,   and other BBS programs during specific times  of  the 
  14.             day or night.   Only designated callers (or  groups) can enter
  15.             a  door  program  during a Sysop defined time  slot  when  the
  16.             correct  password is provided
  17.        
  18.        FOR NETMAIL HUBS
  19.             Netmail Hubs  frequently find  that HUBS  and NODES  call  for
  20.             mail  OUTSIDE their  designated time  slots.  This, of course,
  21.             starts a  domino effect.  TimeLock ENSURES THAT NODES AND HUBS
  22.             CALLING YOU  FOR THEIR  MAIL CAN  ONLY ACCESS  YOUR MAIL DOORS
  23.             DURING THE TIMESLOT YOU DESIGNATE.
  24.        
  25.        GAMES AND OTHER DOORS
  26.             TimeLock is great for controlling access to popular game doors 
  27.             for  tournaments or  contests.   Now  you  can designate  what
  28.             callers have access to particular  GAME DOORS during the hours
  29.             and times you designate.
  30.  
  31.  
  32.  
  33.        HOW TIMELOCK WORKS:
  34.        ───────────────────────────────────────────────────────────────────
  35.             TimeLock.EXE can be placed in any door batch file prior to the 
  36.             command  that actually calls or opens the door. When a  caller 
  37.             attempts  to  open  a TimeLock  protected  door,  TimeLock  is 
  38.             executed first  and retrieves  a password.  The password maybe
  39.             retrieved by  user entry or  from the  DOOR.SYS file.   If the
  40.             password is  valid for  the current  time slot,  then TimeLock
  41.             returns an errorlevel which can be used to allow the caller to
  42.             continue and  run the  door program.   If the  password is not
  43.             valid for the current timeslot, an errorlevel is returned that
  44.             can  be  used  to  return  to  the  board  without opening  or
  45.             executing the protected door program.
  46.  
  47.  
  48.  
  49.        SUMMARY TIMELOCK FEATURES:
  50.        ───────────────────────────────────────────────────────────────────
  51.        *    Allows Bulletin Board Sysops to restrict access to MAIL,  GAME 
  52.             and other  doors using Sysop defined timeslots.
  53.        *    Written for PC Board, GAP, Wildcat and any BBS that produces a 
  54.             DOOR.SYS.
  55.        *    Multi-Node Operation (Registered Version).
  56.        *    Overlapping timeslots with verification (Registered Version).
  57.        *    Usage log (Registered Version).
  58.        *    User definable default time slot increments (Registered Version).
  59.        *    Can retrieve password from DOOR.SYS (Registered Version) or
  60.             request password to be entered.
  61.  
  62.  
  63.  
  64.                                     ( -1- )
  65.        
  66.  
  67.  
  68.  
  69.        TIMELOCK and TIMEDATA:
  70.        ───────────────────────────────────────────────────────────────────
  71.        The TIMEDATA.EXE Program
  72.             TimeData allows you to create a database containing a starting 
  73.             and  ending time (a Time Slot), a caller name or ID (this  can 
  74.             be  a  HUB or Node ID or  a users name), and   a  password  as 
  75.             shown  below.   Note  that  the  caller  id  field is for your
  76.             reference only. The password and current time are all that are
  77.             used to determine whether the errorlevel should be set.
  78.  
  79.             Sample TimeData screen:
  80.            ────────────────────────────────────────────────────────────────
  81.           | START  |  END  |   Caller ID                  |  Password      |
  82.            ────────────────────────────────────────────────────────────────
  83.             20:00    20:15     HUBWOCKY                       XYZ123
  84.             20:15    20:30     THDOOR                         WEBSTER
  85.             20:30    21:00     HUBNY                          ALPHA
  86.             20:55    21:20     HUBWEX                         SARAJ
  87.        
  88.  
  89.        The TIMELOCK.EXE Program
  90.             TimeLock  checks the database when the caller tries to open  a 
  91.             door  or  execute  a program protected by  TimeLock.   If  the 
  92.             password provided (either thru entry or from the DOOR.SYS file)
  93.             is valid for the  current timeslot,  then TimeLock  returns an
  94.             errorlevel  of 0.   If  an  incorrect  password  is  provided,
  95.             TimeLock  returns an  errorlevel or 255.  By testing for these
  96.             errorlevels  in your  door batch  files, you can grant or deny
  97.             access to the program or door.
  98.  
  99.  
  100.  
  101.        EXAMPLE: USING TIMELOCK FOR A HUB MAIL DOOR
  102.        ───────────────────────────────────────────────────────────────────
  103.             Suppose that you want to use TimeLock to protect your HUBS and
  104.             NODES time slots, ensuring that only those designated can call
  105.             in and get their mail during  their  time slot.
  106.  
  107.        
  108.             Example: HUBRIME.BAT
  109.        
  110.              echo off
  111.              Timelock
  112.              If errorlevel = 255 goto end
  113.              If errorlevel = 0 goto mail
  114.              :mail
  115.              F:
  116.              cd F:\RIME\HUB
  117.              rem run the HUB with the proper configuration file
  118.              HUB CONFIG3.HUB REMOTE
  119.              :end
  120.        
  121.             In  the  above example, when the Node or HUB calls  and  opens 
  122.             your Mail  Door,  TimeLock  either  requests  or  retrieves  a
  123.             password. If the password is correct for the current timeslot,
  124.             an errorlevel of 0 is  returned and the  batch file allows the
  125.             caller to open the mail door.  If the  password  is incorrect,
  126.             TimeLock  returns an  errorlevel of 255 and the  caller is not
  127.             permitted to open the mail door.
  128.  
  129.  
  130.                                     ( -2- )
  131.  
  132.  
  133.  
  134.  
  135.        INSTALLING & USING TIMELOCK:
  136.        ───────────────────────────────────────────────────────────────────
  137.        
  138.        TIMLOKxx.ZIP contains the following files:
  139.        
  140.             TIMELOCK.EXE - Program  that  requests  and  verifies  the
  141.                            password entered.
  142.             TIMEDATA.EXE - Program  that  maintains the list  of  time
  143.                            slots and their passwords.
  144.             TIMELOCK.CNF - Sample configuration file for TimeLock.
  145.             TIMEDATA.CNF - Sample configuration file for TimeData.
  146.             TIMELOCK.DOC - This file.
  147.        
  148.        
  149.        To install TimeLock, follow the steps listed below.
  150.        
  151.        
  152.        STEP 1.    Make a directory for the TimeLock programs and files. If 
  153.             you  are using an unregistered version, you will need to  make 
  154.             one  directory  for each node that you wish  to  run  TimeLock      
  155.             on or  you can place the TimeLock  files in each nodes default
  156.             directory.   Registered users may make one area regardless  of 
  157.             the number of nodes.
  158.        
  159.        
  160.        STEP 2.    Make configuration files.   You may use the sample files
  161.             (TIMELOCK.CNF & TIMEDATA.CNF) for this purpose.  Each TimeLock
  162.             configuration file will contain five (5) lines as follows.
  163.  
  164.                  e:\node4            <== Path to system files
  165.                  The Door            <== BBS Name
  166.                  0                   <== 0=Gap/1=PC Board & Everything else
  167.                  N                   <== Maintain Usage file? Y/N 
  168.                  Y                   <== Get password from DOOR.SYS? Y/N
  169.  
  170.             The TIMEDATA.CNF file will contain one (1) line as follows.
  171.  
  172.                  5                   <== Default Time Increment in Minutes
  173.  
  174.             For more information about the configuration files, please view 
  175.             the sample TIMELOCK.CNF and TIMEDATA.CNF files provided.
  176.  
  177.  
  178.        STEP  3:   Establish  your  time slot database  using  the  TimeData
  179.             program.  See page 4 for helpful hints on running this program.
  180.        
  181.  
  182.        STEP 4:    Change the batch files used to run the doors you wish to 
  183.             protect with TimeLock.  (See the previous example.)  Note that
  184.             if  you are a registered user you may pass  the  configuration
  185.             file  name that you wish to use on the command line.  If  this 
  186.             configuration  name is omitted the TimeLock program  will  use 
  187.             the TIMELOCK.CNF file.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                     ( -3- )
  197.  
  198.  
  199.        
  200.  
  201.        USING TIMEDATA
  202.        ───────────────────────────────────────────────────────────────────
  203.        The TimeData program  allows you to establish the database  of time
  204.        slots  and which  passwords will  activate them.  Note that you may
  205.        enter the Caller Name, Hub Name, or Node ID in the Caller ID field.
  206.        However,  the ID field is for  your  reference  only  and  plays no
  207.        part in determining whether the password provided is valid.
  208.  
  209.        Remember, if you are a  registered user and  you wish to  establish
  210.        default time increments, then view and modify the TIMEDATA.CNF file
  211.        accordingly.   If  you  do  not  wish  to  establish  Default  Time
  212.        increments, simply delete the TIMEDATA.CNF file.
  213.  
  214.        The  TimeData  program is  very  straight  forward and easy to use.
  215.        However, a few helpful hints never hurt.
  216.  
  217.        1.  To select a menu item you may use your arrow keys, or press the
  218.            first letter  of the item.  Note that  PAGE UP will function as
  219.            Previous, PAGE DOWN will function as Next and ESC will function
  220.            as Quit.   The ESC key  will also  abort the Adding &  Changing
  221.            functions and return to the menu.
  222.        
  223.        2.  When the  program requests  a Yes or No  response, the  default
  224.            answer will appear in uppercase. For example, by pressing Enter
  225.            at the "Is this Correct? Y/n" prompt you would be selecting the 
  226.            uppercase response, or "Y".
  227.        
  228.        3.  Your arrow keys work in moving  around the screen and the menu,
  229.            but do not  work well in editing.  So when you  are changing a
  230.            field, use your backspace key.
  231.        
  232.        4.  Times will be entered as hhmm, with no colon, it will be added
  233.            for you. Make sure you pad your entries with zeros (i.e. 0500)
  234.            and use a 24 hour clock.
  235.        
  236.        5.  If you established  a default  time slot  length, you will not
  237.            need to enter an  Ending Time, just  press enter  and TimeData
  238.            will enter it for you.
  239.        
  240.        
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                     ( -4- )
  263.  
  264.  
  265.  
  266.  
  267.        LEGALITIES
  268.        ───────────────────────────────────────────────────────────────────
  269.  
  270.        DISTRIBUTION
  271.             TimeLock is distributed in 2 forms. The DEMONSTRATION  VERSION 
  272.             which has some features partially enabled and, the  REGISTERED 
  273.             VERSION which is fully functional and has some added features.  
  274.             The   DEMONSTRATION   VERSION  of  TimeLock  may   be   freely  
  275.             distributed and is provided for EVALUATION purposes. To obtain 
  276.             a  registered version of TimeLock, you should send  $15.00  US 
  277.             dollars  plus  $2.50  for  postage and  handling  or  you  may 
  278.             register  TimeLock online using VISA or MASTERCARD by  calling 
  279.             The DOOR BBS & Information Network at the number listed below.
  280.        
  281.                               The DOOR BBS & Information Network
  282.                               5-Nodes US Robotics DS/V.32bis/HST
  283.                               407-682-3132
  284.                               Peiman & Associates Inc.
  285.                               629 Peachwood Drive
  286.                               Altamonte Springs, FL. 32714 
  287.        
  288.             As a registered user, you will receive:
  289.        
  290.                 o  The right to continue using TimeLock
  291.                 o  The latest version of TimeLock
  292.                 o  Updates for 1 Year
  293.                 o  Additional Program Features  
  294.                 o  Technical support via The DOOR BBS, (407-682-3132)
  295.        
  296.        COPYRIGHT NOTICE
  297.             This software and accompanying documentation are Copyright (c) 
  298.             1991 by Peiman & Associates Inc.. All rights are reserved.
  299.        
  300.        LIABILITY LIMITATION
  301.             Peiman & Associates, Inc., (PAI) does not assume any liability 
  302.             for the use of TimeLock beyond the original purchase price  of 
  303.             the  software.   In  no event will PAI be liable  to  you  for 
  304.             additional damages,  including, but not limited to,  any  lost 
  305.             profits,   lost savings or  other incidental or  consequential 
  306.             damages  arising  out of the use of or inability to  use  this 
  307.             program,  even if PAI  has been advised of the possibility  of 
  308.             such damages.  By using this software, you agree to the  terms 
  309.             of this section.  If you don't agree, immediately cease use of 
  310.             and return the entire TimeLock package for a refund.
  311.        
  312.        LICENSE AGREEMENT
  313.             You are hereby granted a limited license to evaluate  TimeLock 
  314.             period not to exceed 30 days. 
  315.        
  316.        TRADEMARKS
  317.             All  PAI  Software  products  are  trademarks  or   registered 
  318.             trademarks  of  Peiman  & Associates  Inc..  Other  brand  and 
  319.             product names are trademarks or registered trademarks of their 
  320.             respective holders.
  321.        
  322.        REPORTING PROBLEMS
  323.             If  you encounter any problems with TimeLock which  you  think 
  324.             might  be a bug, please report it to us at the address  above, 
  325.             or contact us on the DOOR BBS.
  326.  
  327.  
  328.                                     ( -5- )
  329.  
  330.  
  331.  
  332.  
  333.        REGISTRATION FORM
  334.        ───────────────────────────────────────────────────────────────────
  335.        
  336.          Registration Fee      $15.00                         $  ____________
  337.          Shipping & Handling   $ 2.50                         $  ____________
  338.                                                               ---------------
  339.          Total                                                $  ____________
  340.        
  341.        I wish to pay by 
  342.        
  343.           [__] Check  - Make payable and send to Peiman & Associates,  Inc. 
  344.                  at Post Office Box 948219, Maitland, Florida, 32794.
  345.           [__] Credit Card - Fill in the credit card information below.
  346.        
  347.        
  348.        We will either send the registered version or you can download it along
  349.        with your registration key file from, The DOOR BBS, (Tm) & Information
  350.        Network at  407-682-3132, (3-Nodes, USR DS/V.32bis/HST).
  351.        
  352.        Please Check the Appropriate box:
  353.             [__] I wish  my  copy  sent  via US  Mail.   Pick  one  of  the 
  354.                  following medias (  ___ 5.25"    ___ 3.5"  )
  355.             [__] I wish to download my copy.
  356.        
  357.        
  358.        Complete ALL of the following information:
  359.        
  360.        Sysop Name: _____________________________________________
  361.        
  362.        Board Name: _____________________________________________
  363.        
  364.           address: _____________________________________________
  365.        
  366.                    _____________________________________________
  367.        
  368.              City: _____________________________________________
  369.              
  370.             State: ___________  ZIP: ___________ Phone: ___________________
  371.        
  372.        
  373.        (For Downloads Only)
  374.        Username: ___________________________________________
  375.        
  376.        Password: ___________________________________________
  377.        
  378.        
  379.        (For Credit Card Purchases)
  380.        
  381.        Name : _____________________________________________________________
  382.               (as it appears on your credit card)
  383.        
  384.        Type of Card :   ___ Mastercard   ___ Visa   ___ Diner's Club
  385.         
  386.                         ___ Carte Blanche
  387.        
  388.        Exp Date : ______    Issuing Bank : ________________________________
  389.        
  390.        Signature : ________________________________________________________
  391.        
  392.        
  393.        
  394.  
  395.  
  396.  
  397.